package org.eiahe.hr.attendance.service;

import org.eiahe.hr.attendance.domain.bo.HolidayBo;
import org.eiahe.hr.attendance.domain.vo.HolidayVo;
import org.ehe.common.mybatis.core.page.PageQuery;
import org.ehe.common.mybatis.core.page.TableDataInfo;

import java.util.Collection;
import java.util.List;

/**
 * 节假日服务接口
 *
 * @author zhangnn
 */
public interface IHolidayService {

    /**
     * 查询节假日
     *
     * @param holidayId 节假日ID
     * @return 节假日信息
     */
    HolidayVo queryById(Long holidayId);

    /**
     * 查询节假日列表
     *
     * @param bo 节假日业务对象
     * @return 节假日列表
     */
    List<HolidayVo> queryList(HolidayBo bo);

    /**
     * 分页查询节假日列表
     *
     * @param bo        节假日业务对象
     * @param pageQuery 分页参数
     * @return 节假日分页列表
     */
    TableDataInfo<HolidayVo> queryPageList(HolidayBo bo, PageQuery pageQuery);

    /**
     * 新增节假日
     *
     * @param bo 节假日业务对象
     * @return 是否成功
     */
    Boolean insertByBo(HolidayBo bo);

    /**
     * 修改节假日
     *
     * @param bo 节假日业务对象
     * @return 是否成功
     */
    Boolean updateByBo(HolidayBo bo);

    /**
     * 批量删除节假日
     *
     * @param ids 节假日ID集合
     * @return 是否成功
     */
    Boolean deleteWithValidByIds(Collection<Long> ids);

    /**
     * 同步指定年份的节假日数据
     * 调用外部API(如https://timor.tech/api/holiday/year/{year})获取节假日数据
     *
     * @param year 年份
     * @return 同步成功的记录数
     */
    Integer syncHolidaysByYear(Integer year);

    /**
     * 批量导入节假日
     *
     * @param holidays 节假日列表
     * @return 导入成功的记录数
     */
    Integer batchImportHolidays(List<HolidayBo> holidays);
}
